home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / ditroff / RCS / trchange.man,v < prev   
Encoding:
Text File  |  1990-07-12  |  4.2 KB  |  177 lines
  1. head     1.1;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    stolcke:1.1; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.1
  10. date     90.07.11.17.55.43;  author stolcke;  state Exp;
  11. branches ;
  12. next     ;
  13.  
  14.  
  15. desc
  16. @@
  17.  
  18.  
  19.  
  20. 1.1
  21. log
  22. @Initial revision
  23. @
  24. text
  25. @.TH TRCHANGES l
  26. .de P1
  27. .nf
  28. .ta 5 10 15 20 25 30 35 40 45 50 55 60
  29. .sp 1
  30. ..
  31. .de P2
  32. .fi
  33. .sp 1
  34. ..
  35. .hy 14    \"2=not last lines; 4= no -xx; 8=no xx-
  36. .SH COMMAND LINE ARGUMENTS
  37. .PP
  38. The argument
  39. .BI \-P xxx
  40. loads parameters and character definitions for typesetter
  41. .IR xxx ,
  42. which at the moment is typically one of
  43. .IR ip " (imagen),"
  44. .IR va " (varian),"
  45. .IR vp " (versatec)"
  46. or
  47. .IR ter " (terminal or printer)."
  48. .PP
  49. .BI -F yyy
  50. causes font information to be loaded from directory
  51. .I yyy
  52. instead of the default
  53. .BI /usr/lib/font/dev xxx.
  54. .SH GRAPHICS COMMANDS
  55. .PP
  56. The most significant new facility is the ability to draw
  57. simple graphical objects  
  58. \(em diagonal lines, circles, ellipses, arcs, splines, and filled polygons \(em
  59. in TROFF .
  60. .PP
  61. The new graphical commands are
  62. .P1
  63. .ta 1i
  64. \eD'l\f2 dh dv\fP'
  65.     draw line from current position by \f2dh, dv\fP
  66. \eD'c\f2 d\fP'
  67.     draw circle of diameter \f2d\fP with left side at current position
  68. \eD'e\f2 d1 d2\fP'
  69.     draw ellipse of diameters \f2d1 d2\fP
  70. \eD'a\f2 dh1 dv1 dh2 dv2\fP'
  71.     draw arc counter-clockwise from current position to \f2dh1+dh2
  72.     dv1+dv2\fP, with center at \f2dh1 dv1\fP from current position
  73. \eD'~\f2 dh1 dv1 dh2 dv2 ...\fP'
  74.     draw B-spline from current position by \f2dh1 dv1\fP
  75.     then by \f2dh2, dv2\fP, then by \f2dh3, dv3\fP, then ...
  76. \eD'g\f2 dh1 dv1 dh2 dv2 ...\fP'
  77.     same as \eD'~\f2 dh1 ...\fP' except the gremlin spline
  78.     algorithm is used.
  79. \eD'p\f2 n dh1 dv1 dh2 dv2 ...\fP'
  80.     draw polygon using stipple \f2n\fP from current stipple font
  81.     starting at current position by \f2dh1 dv1\fP then by \f2dh2, dv2\fP,
  82.     then by \f2dh3, dv3\fP, then ...
  83. \eD'P\f2 n dh1 dv1 dh2 dv2 ...\fP'
  84.     same as \eD'p\f2 n dh1 ...\fP' except no border is printed.
  85. \eD't\f2 d\fP'
  86.     set line thickness to \f2d\fP (set to 3 units at startup).
  87.     The default units are ems, so \f2d\fP must be given in \f2u\fP
  88.     units if a number of pixels is needed.
  89. \eD's\f2 d\fP'
  90.     set line style to \f2d\fP (set to -1 at startup).  The value is
  91.     taken as a coordinate mask on the individual bits of the line.
  92.     The default units are ems, so \f2d\fP must be given in \f2u\fP units.
  93. .P2
  94. The position after a graphical object has been drawn is
  95. at its ``end'', where for circles and ellipses, the end
  96. is at the right side.
  97. As with other commands,
  98. default units are ems horizontally and line spaces vertically.
  99. .PP
  100. Realistically, these commands are not intended for direct use,
  101. but for preprocessors like PIC, IDEAL, and GRN.
  102. .SH Other new commands
  103. .PP
  104. .BI .sy " commandline"
  105. executes the command, then returns.
  106. Output is not captured anyplace.
  107. .PP
  108. .BI .cf " file"
  109. copies
  110. .I file
  111. into the TROFF output file at this point, uninterpreted.
  112. Havoc ensues unless the motions in the file
  113. restore current horizontal and vertical position.
  114. This command hasn't been used much,
  115. and is probably a bad idea anyway.
  116. .PP
  117. .BI .pi " program"
  118. (pipe the output into
  119. .IR program )
  120. now works in TROFF as well as NROFF,
  121. since it makes somewhat more sense to allow it.
  122. .PP
  123. .BI .st " stipple_font"
  124. loads
  125. .I stipple_font
  126. as the current font used to fill polygons, with each
  127. polygon command selecting one pattern number from the font.
  128. The available stipple fonts are listed in the "font" manual page.
  129. .PP
  130. The number register
  131. .B $$
  132. contains the process id of the TROFF process.
  133. .PP
  134. The string
  135. .B .T
  136. contains the name of the current typesetter
  137. (e.g.,
  138. .IR va ,
  139. .IR vp ,
  140. .IR ip ).
  141. .PP
  142. The
  143. .B .ft
  144. command causes the named font to be loaded on font position 0
  145. (which is in all other ways inaccessible) if the font exists
  146. and is not currently mounted by default or by a
  147. .B .fp
  148. command.
  149. The font must be still or again in position 0 when the line is printed.
  150. .PP
  151. Transparent mode (\e!) has been fixed so that transparent
  152. output actually appears in the output;
  153. thus special commands can be passed through to postprocessors
  154. by witchcraft like
  155. .P1
  156. \&.if "\e*(.T"va" \e!x ...
  157. .P2
  158. (If this makes no sense to you,
  159. you shouldn't be using it anyway.)
  160. .SH Deletions
  161. .PP
  162. The
  163. .B .fz
  164. and
  165. .B .li
  166. commands are no more.
  167. The
  168. .BR -p ,
  169. .B -g
  170. and
  171. .B +n
  172. command line arguments have also been eliminated,
  173. as has the
  174. .B hp
  175. number register.
  176. @
  177.